3D Graphics Programming with QuickDraw 3D 1.5.4

Obtaining a DrawRegion

Draw regions are attached to the draw context by QuickDraw 3D. Typically, there will be one draw region per monitor attached to a machine. A draw region is an opaque structure:



 
typedef struct TQ3XDrawRegionPrivate *TQ3XDrawRegion;

You can use the Q3XDrawContext_GetDrawRegion routine to get the first draw region attached to a draw context. If there are additional draw regions, the rest of them can be obtained by repeated calls to Q3XDrawRegion_GetNextRegion. Your Q3XDrawRegion_GetNextRegion call will return NULL after the last draw region has been retrieved.

Q3XDrawContext_GetDrawRegion

The Q3XDrawContext_GetDrawRegion function lets you obtain the first draw region attached to a draw context.



 
TQ3Status Q3XDrawContext_GetDrawRegion(

                     TQ3DrawContextObject    drawContext,

                     TQ3XDrawRegion          *drawRegion);

drawContext: A draw context.
drawRegion: On return, the first draw region attached to drawContext.

DESCRIPTION

The Q3XDrawContext_GetDrawRegion function returns, in the drawRegion parameter, the first draw region attached to the draw context designated by the drawContext parameter.

Q3XDrawRegion_GetNextRegion

The Q3XDrawRegion_GetNextRegion function returns additional draw regions attached to a draw context.



 
TQ3Status Q3XDrawRegion_GetNextRegion(

                     TQ3XDrawRegion    drawRegion,

                     TQ3XDrawRegion    *nextDrawRegion);

drawRegion: The draw region returned by Q3XDrawContext_GetDrawRegion.
nextDrawRegion: An additional draw region attached to the same draw context, or NULL if there are no more.

DESCRIPTION

The Q3XDrawRegion_GetNextRegion function returns, in the nextDrawRegion parameter, a draw region attached to the same draw context as drawRegion. It returns NULL after it has returned all the draw regions for that draw context.